Inside Macintosh: QuickTime Components /

Chapter 3 - Standard Image-Compression Dialog Components / Standard Image-Compression Dialog Components Reference

Standard Image-Compression Dialog Component Functions / Positioning Dialog Boxes and Rectangles

SCGetBestDeviceRect

The SCGetBestDeviceRect function determines the boundary rectangle that surrounds the display device that supports the largest color or grayscale palette.

pascal ComponentResult SCGetBestDeviceRect (ComponentInstance ci,
                                             Rect *r);

ci

Identifies your application's connection to a standard image-compression dialog component.

r

Contains a pointer to a rectangle structure. The SCGetBestDeviceRect function returns the global coordinates of a rectangle that surrounds the appropriate display device.

DESCRIPTION

The SCGetBestDeviceRect function determines the boundary rectangle that surrounds the display device that supports the largest color or grayscale palette. If more than one device supports the same pixel depth, the function returns information about the device that has the highest resolution.

Note that the function subtracts the menu bar from the returned rectangle if the best device is also the main display device.

The standard image-compression dialog component uses this function to position rectangles and dialog boxes when you indicate that the component is to choose the best display device. In general, your application does not need to use this function.

RESULT CODE

paramErr

-50

Invalid parameter specified

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help